• Compare the last tag with the branch upon which you want to release (next for the alpha / beta releases and master for the current stable version).
  To do so, use yarn release:changelog The options are the following:

  yarn release:changelog
     --githubToken   YOUR_GITHUB_TOKEN (needs "public_repo" permission)
     --lastRelease   The release to compare against (default: the last one)
     --release       The branch to release (default: master)

  You can also provide the github token by setting process.env.GITHUB_TOKEN variable.

  In case of a problem, another method to generate the changelog is available at the end of this page.

• Clean the generated changelog, to match the format of https://github.com/mui/mui-x/releases.

• Update the root package.json's version

• Update the versions of the other package.json files and of the dependencies with yarn release:version (yarn release:version prerelease for alpha / beta releases).

• Open PR with changes and wait for review and green CI.

• Merge PR once CI is green, and it has been approved.

Release the packages

• Checkout the last version of the working branch
• Make sure you have the latest dependencies installed: yarn.
• Build the packages: yarn release:build.
• Release the versions on npm: yarn release:publish (you need your 2FA device).
• Push the newly created tag: yarn release:tag.

Publish the documentation

The documentation must be updated on the docs-vX branch (docs-v4 for v4.X releases, docs-v5 for v5.X releases, ...)

• Push the working branch on the documentation release branch to deploy the documentation with the latest changes.

git push upstream master:docs-v6 -f

You can follow the deployment process on the Netlify Dashboard
Once deployed, it will be accessible at https://material-ui-x.netlify.app/ for the docs-v6 deployment.

Publish GitHub release

• After documentation is deployed, publish a new release on GitHub releases page

Announce

• Follow the instructions in https://mui-org.notion.site/Releases-7490ef9581b4447ebdbf86b13164272d.